Skip to content

Purge record versions

Request

The API for the given record id, performs the permanent physical deletion record versions excluding latest version and any linked records or files if there are any. If 'limit' query parameter is used then it will delete oldest versions defined by 'limit'. This operation cannot be undone. Required roles: 'users.datalake.admins' who is the OWNER of the record.

Security
Authorization
Path
idstringrequired

Record id

Note: If the Record ID contains encoded characters (e.g., %5B, %5D, etc.), ensure that you url-encode the Record ID to avoid issues with URL decoding. For example, if your Record ID is opendes:test:%5BUS%5D, you should encode it as opendes%3Atest%3A%255BUS%255D.

Query
limitintegerrequired

Number of oldest record versions to be deleted. Value must not exceed number of record versions (excluding latest version)

Headers
data-partition-idstringrequired

Tenant Id

curl -i -X DELETE \
  'https://as5.api.enterprisedata.slb.com/api/storage/v2/records/{id}/versions?limit=0' \
  -H 'data-partition-id: string'

Responses

Record Versions deleted successfully.

Response
No content